home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BBS / VBBSA6_2.ARJ / VFIDO.DOC < prev    next >
Text File  |  1993-02-14  |  20KB  |  485 lines
  1. VBBS / Fido Gateway Version 5.60.07
  2. ===================================
  3.  
  4. Copyright Neil J Marshall 10th February 1993
  5.     TransAtlanticBBS (+44-689-890937)
  6.         1 @ 440 VirtualNET
  7.         Neil J Marshall @ 2:440/211 Fido
  8.  
  9.  
  10. Contents
  11. ========
  12.  
  13. Introduction
  14. Initial Configuration Of VFIDO To Give E-Mail Functionality
  15. Configuration Of VFIDO To Add Conference Functionality
  16. Configuration Of VFIDO To Add Interface To FrontDoor
  17. Creation Of A Fido Network List For Use By VBBS
  18. Summary Of VFIDO Command Syntax
  19. Technical Information
  20. Development History
  21.  
  22.  
  23. Introduction
  24. ============
  25.  
  26. This program is designed to create an interface between the VBBS
  27. software written by Roland De Graaf and any Fido-compatible
  28. network. FidoNET itself is the largest hobbyist network in the
  29. world, with over 14,000 BBS as members, and there are literally
  30. thousands of smaller Fido-compatible networks worldwide.
  31.  
  32. This version of the interface program allows the exchange of
  33. private mail and public message areas between VBBS and Fido. It
  34. no longer requires the use of FrontDoor to handle the calls to and
  35. from other Fido BBS, although you can continue to use FrontDoor if
  36. you so desire.
  37.  
  38.  
  39. Initial Configuration Of VFIDO To Give E-Mail Functionality
  40. ===========================================================
  41.  
  42. Place the VFIDO.EXE program in your VBBS directory.
  43.  
  44. Run VCONFIG.EXE, and select Network Configuration for the Fido
  45. (type 4) network you are configuring.
  46.  
  47. 1. Fido Address:       2:440/211
  48.     Your Fido network primary address in Zone:Net/Node.Point format)
  49. 2. NetMail Directory:  C:\VBBS\NETMAIL
  50.     Where Fido netmail will be stored - must be the same for all your
  51.     Fido networks
  52. 3. OutBound Directory: C:\VBBS\OUTBOUND
  53.     Where Fido EchoMail will be stored - must be the same for all your
  54.     Fido networks
  55. 4. Archiver:           PAK
  56.     Compression method for outgoing EchoMail - PAK, LHA, ZIP, ARJ
  57. 5. UnArchiver:         PAK
  58.     Compression method for incoming EchoMail - PAK, LHA, ZIP, ARJ
  59. 6. FIDO Front-End:     Standalone
  60.     Standalone or FrontDoor are only valid options at this stage
  61. 7. Nodelist Name:      NODELIST
  62.     The name of the nodelist for the network
  63. 8. Zones:              1-7
  64.     The range of Zones that belong to that network (ie the Domain)
  65.  
  66. D. Dial List
  67.     1. System Address:         2:440/59
  68.         Fido address of node to call
  69.     2. Phone Number:           0689-824890
  70.         Full phone number to dial
  71.     3. Poll Priority:          Hold
  72.         Hold means never call, Priority is call as soon as mail is
  73.         waiting, once a day is the final option
  74.     4. Preferred Session Type: EMSI (FSC-0056) w/Zmodem (DSZ)
  75.         EMSI or TSYNCH handshaking selection
  76.     5. Session Password:       FRED
  77.         The password to use in the EMSI session with the other BBS,
  78.         which may be blank
  79.  
  80. R. Routing
  81.     1: 2:440/59 2:440/59
  82.         Fido address of server and routing mask including wildcards. The
  83.         routing logic works top to bottom through this list so you can't
  84.         add anything meaningful after the last line with the *:*/* on it.
  85.     2: 1:1/1 1:*/*
  86.     3: 2:440/6 *:*/*
  87.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  88.  
  89. A. AKAs
  90.     1: 2:440/59.3
  91.         Alternative address for the board - must be same Zone
  92.     2: 2:440/0
  93.    A)dd Lines E)dit Lines D)elete Empty Lines Q)uit:
  94.  
  95. Once this configuration is completed, go to the main VBBS directory
  96. and run:
  97.  
  98. VFIDO /C NETWORKID=#
  99.  
  100. You must rerun this every time you change the above configuration
  101. information.
  102.  
  103. You will also need set up a file containing phone prefix aliases
  104. called VFIDO.FON in your DATA subdirectory. This is used to ensure
  105. that the phone numbers listed in the nodelist are converted to a
  106. format that can be dialed from your BBS. This is used for removing
  107. your country code for national calls and area code for local calls.
  108. VFIDO needs the correct phone numbers listed so it can call any BBS
  109. in the nodelist when Crash Mail, File Attaches or File Requests are
  110. sent.
  111.  
  112. An example of this file for the USA would be:
  113.  
  114. 011-            The prefix for dialing international phone numbers
  115. 1-616-399- 399- Sets up the toll free codes for your area code
  116. 1-616- 1-       Makes all other calls in your area code long distance
  117. 1- 1-           Ensures all US phone numbers are not made international
  118.  
  119. This example would convert a phone number listed as 1-616-399-4818 to
  120. 399-4818, or convert 1-616-772-0482 to 1-772-0482, or 44-689-890937 to
  121. 011-44-689-90937
  122.  
  123. and for Europe:
  124.  
  125. 010-            The prefix for international calls
  126. 44-689-         Strip the country and area code for local calls
  127. 44- 0-          Add a 0 prefix for national calls
  128.  
  129. As an example, the above would convert an international phone number
  130. listed in the nodelist as 1-616-399-4818 to 010-1-616-399-4818, or a
  131. national number in the nodelist as 44-689-890937 to 0-689-890937.
  132.  
  133. Place the unarchived nodelist into the C:\VBBS\NETMAIL directory and
  134. run:
  135.  
  136. VFIDO /A NETWORKID=#
  137.  
  138. You will need to rerun this every time you receive a new NODELIST or
  139. you change the VFIDO.FON.
  140.  
  141.  
  142. Sending E-Mail Using VFIDO
  143. ==========================
  144.  
  145. To send an E-Mail message from VBBS to any Fido-type network, invoke
  146. the E-Mail routine as normal. The User Network Address field should be
  147. completed in the format User Name@Fido Address, so to send E-Mail to me
  148. use Neil J Marshall@2:440/211.
  149.  
  150. If you want to send Crash Mail, that is where the E-Mail is sent
  151. directly to the addressee's BBS, ignoring the routing logic, then
  152. add a " +c" after the addressee's name, so to send Crash Mail to me use
  153. Neil J Marshall +c@2:440/211.
  154.  
  155. In Fido-type networks it is policy that messages with files attached
  156. must go directly to the addressee's BBS and ignore the routing logic,
  157. so if you attach a file to a message it will be held on your board
  158. awaiting a call from the addressee's BBS unless you send it Crash Mail
  159. or the addressee is one of the BBSs in your dialing list that you call.
  160.  
  161.  
  162. File Requests Using VFIDO
  163. =========================
  164.  
  165. If you want to send a File Request to another Fido-type BBS invoke the
  166. e-mail routine as normal. The User Network Address field should be
  167. completed in the format Sysop +f@Fido Address, where the " +f" is the
  168. switch to indicate this is a File Request. The Filename requested is
  169. put in the Title field of the message. All File Requests are sent direct
  170. to the addressee's BBS and ignore routing. If the addressee's BBS is not
  171. one that you have set up in your dialing list, then you must also use
  172. the +c switch to make the File Request a Crash E-Mail. To request the
  173. latest version of VFIDO from me, you would invoke the E-Mail function
  174. and address it to Sysop +f +c@2:440/211, then make the Title of the
  175. message VFIDO.
  176.  
  177. VFIDO also supports incoming File Requests. When a File Request is
  178. received, VFIDO searches each of the File Areas that you have set up in
  179. VCONFIG and sends the file back if it is found. VFIDO also supports
  180. "Magic Names" for File Requests - this is where a pseudonym is
  181. associated with an actual file for ease of access by calling systems.
  182. Magic Names should be set up in the file VFIDO.MAG in your DATA
  183. directory. The format of this file is one entry per line, giving the
  184. "Magic Name" followed by the full path and filename of the file to
  185. associate with the Magic Name, for example
  186.     VBBS C:\VBBS\FILES\SYSOP\VBBS560.ZIP
  187.     FILES C:\VBBS\MASTLIST.TXT
  188.     VFIDO C:\VBBS\FILES\SYSOP\VFIDO560.ZIP
  189. might be some of the most common ones.
  190.  
  191. If you want a "standard letter" sent in response to each file request,
  192. create this letter in a file called FILEREQ.TXT in your TEXT path.
  193. Generally a Fido Sysop should use this to list the Magic Names
  194. applicable to their BBS.
  195.  
  196.  
  197. Configuration Of VFIDO To Add Conference Functionality
  198. ======================================================
  199.  
  200. If you want to access public message areas in Fido, you will
  201. need to know the AREA name that uniquely identifies each Fido
  202. conference. Supposing for example you wished to set up VBBS to
  203. participate in a Fido conference whose AREA name was HARPOON:
  204.  
  205. Run VCONFIG.EXE and select Database Configuration, Message Bases,
  206. the relevant Group and Database. Then select Networks Configuration,
  207. A for add, select the network, and on the line for the Network
  208. Conference Identifier, put the AREA name of the Echomail conference
  209. in the network, and ALSO, separated by a space, the Fido addresses of
  210. the nodes to whom you directly circulate the conference, if you are
  211. acting as a local hub. You are currently limited to 80 characters here
  212. so you can't become a major hub yet. The line will look like this:
  213.  
  214. Network Conference Identifier: HARPOON 2:440/59 1:2/3
  215.                                ^       ^
  216.                                *       *
  217.                                *       *
  218.                                *  These are the Fido addresses of
  219.                                *  the next BBS in the conference's
  220.                                *  circulation list
  221.                                *
  222.                    This is the AREA name of the Fido
  223.                    conference
  224.  
  225. After you have set up all your conferences, you must run VCONFIG,
  226. Database Configuration, Compile Network Configuration - and you
  227. will have to rerun this every time you change the network configuration
  228. of a database.
  229.  
  230. With these simple steps taken, every message posted on that
  231. conference will be echoed to Fido, and every message from Fido
  232. on that conference will be fed into VBBS.
  233.  
  234.  
  235. Using AreaFix To Request Conferences
  236. ====================================
  237.  
  238. You can add or remove your BBS to the subscription list for conferences
  239. on other Fido BBS using AreaFix.
  240.  
  241. All you have to do is to send a NetMail to AreaFix at the BBS address
  242. with your AreaFix password as the title (the AreaFix password is agreed
  243. in advance by yourself and the other Sysop) and a content that lists,
  244. line by line, the Area name of a conference, preceded by a - for remove.
  245.  
  246. For example, a message whose content read:
  247.  
  248. VFIDO_SUPPORT
  249. -GAMES_DISCUSSION
  250.  
  251. would add your BBS to the VFIDO_SUPPORT conference and remove it from
  252. the GAMES_DISCUSSION conference.
  253.  
  254. VFIDO supports incoming AreaFix requests as well. However, there is no
  255. facility for implementing an AreaFix password, so the title of the
  256. NetMail can be anything. 
  257.  
  258.  
  259. Summary Of VFIDO Command Syntax
  260. ===============================
  261.  
  262. VFIDO {channel number} {option} NETWORKID=#
  263.  
  264. # is the network identifier as specified in the NET.0 file for
  265. the network you are connecting to.
  266.  
  267. {channel number} is only necessary with /DIAL, /HOST and /POLL options.
  268.  
  269. {option} is one of:
  270.  
  271. /A      Build network list from nodelist
  272. /C      Compile initial Fido information
  273. /DIAL   Make a call to another Fido address, specifying the address
  274.         right after the switch like /DIAL2:440/211
  275. /HOST   Answer an incoming Fido call
  276. /POLL   Call all systems for whom Crash Mail is pending
  277. /U      Scan VBBS mail and toss to Fido
  278. /T      Scan Fido mail and toss to VBBS
  279.  
  280.  
  281. Technical Information
  282. =====================
  283.  
  284. VFIDO creates FTS-0001 packets for NetMail with FSC-0039 extensions for
  285. Zone and Point 4D addressing, FTS-0004 ARCmail packets for EchoMail,
  286. and FTS-0006 WaZOO-format File Requests.
  287.  
  288. Connections can be using FTS-0001 (TSynch) using XMODEM or
  289. FSC-0056 (EMSI) using ZModem.
  290.  
  291. Outgoing Crash Mail is only supported using EMSI.
  292.  
  293. VFIDO uses the DOS DIR command. You must therefore ensure that any
  294. programs such as 4DOS which change the output of the DIR command from
  295. the default DOS format are disabled before running VFIDO.
  296.  
  297.  
  298. Release Notes
  299. =============
  300.  
  301. 5.60.07 Modified incoming mail user name recognition to cope with
  302.         names with the first character missing
  303. 5.60.07 Overhauled the FTS-0001 packet exchange section to get better
  304.         results with Binkley connects
  305.  
  306. 5.60.06 Modified packet creation routine to make the packet show
  307.         the address in the correct network as the origin
  308. 5.60.06 Corrected a bug caused by the switch to 60 byte null
  309.         packets in 5.60.05 which caused outgoing mail to be
  310.         ignored or two bytes out of phase
  311.  
  312. 5.60.05 Modified the /c and /f email switches to +c and +f
  313.         because of conflict with MultiMail function
  314. 5.60.05 Modified null packet length to the correct 60 bytes
  315. 5.60.05 Modified EchoMail processing to detect NetMail containg
  316.         AREA: in the text as NetMail instead of EchoMail
  317. 5.60.05 Introduced a quick return to Waiting For Call where call
  318.         was unsuccessful
  319. 5.60.05 Modified incoming and outgoing call routines to improve
  320.         success rate with VFIDO, FrontDoor and Binkley connects
  321. 5.60.05 VFIDO now remembers the telephone numbers of Crash Mailed
  322.         systems so the nodelist does not need to be searched again
  323.         if further Crash Mail is sent or redials are needed
  324. 5.60.05 Modified routine that processes EMSI caller's address
  325.         information to handle 5D addressing and spurious .0
  326.         point addresses
  327.  
  328. 5.60.04 Modified telephone answering routine to handle incoming
  329.         Binkley 2.56 calls using EMSI or FTS-0001
  330. 5.60.04 Modified incoming file request processor to take account
  331.         of comments and directory names
  332. 5.60.04 Improved the incoming EMSI handshake performance
  333. 5.60.04 Modified the EMSI handshake routine to detect carrier
  334.         dropped right at the start of the handshake
  335. 5.60.04 Modified the routine to detect nodelists in VFIDO /A
  336.         so that it runs a bit faster
  337.  
  338. 5.60.03 Corrected bug in Crash Mail introduced in 5.60.02
  339. 5.60.03 Incoming EchoMail is now forced to appear from the same
  340.         network as it is addressed to, preventing reflection
  341. 5.60.03 Added even more code to remove junk in incoming MSGID,
  342.         REPLY and Origin fields
  343.  
  344. 5.60.02 Corrected bug in receive EMSI handshaking that was
  345.         causing an infinite loop
  346. 5.60.02 Corrected a bug causing a crash if you sent crash mail
  347.         to the same address more than once then made a connect
  348. 5.60.02 Modified incoming mail processor to add a /c to crash
  349.         mail to allow the reply to be sent as crash mail
  350.         automatically
  351. 5.60.02 Changed MSGID, REPLY and * Origin routines to detect
  352.         where Zone is 0 and default the network to FidoNET
  353. 5.60.02 Completely rewrote inbound EchoMail processor to allow
  354.         for situations when the from and to addresses are in
  355.         completely different networks
  356. 5.60.02 Corrected origin network processing for mail whose
  357.         origin line indicates an invalid Zone
  358. 5.60.02 Corrected incoming File Request processing routine
  359. 5.60.02 Suppressed sending of null packets during EMSI session
  360. 5.60.02 Enabled routing to #:#/0 addresses
  361. 5.60.02 Corrected routine that takes modem off hook during
  362.         tossing to use correct COM: port and only activate if
  363.         VCONFIG is set to Idle Modem
  364. 5.60.02 Checks VCONFIG file request flag to see if file areas
  365.         are FREQ'able or not
  366. 5.60.02 Added code to recover from invalid addresses in the 
  367.         REPLY field from other Fido mailers
  368. 5.60.02 Added some strategically placed pauses to allow screen 
  369.         to be read to assist debugging
  370. 5.60.02 Spacebar now aborts the whole redial sequence for a node
  371. 5.60.02 Checks for null packets received during a TSynch session
  372.         to prevent attempting to apck mail for 0:0/0
  373.  
  374. 5.60.01 Modified the /POLL routine to only poll within the
  375.         specified NETWORKID
  376. 5.60.01 Added display of EchoMail From Address during tossing
  377.         to assist correct configuration of EchoMail processor.
  378. 5.60.01 Corrected TSYNCH handshake to cope with empty incoming
  379.         packets
  380. 5.60.01 Corrected the AreaFix message format to follow the Fido
  381.         standard for add requests
  382. 5.60.01 Modified the initial handshake after CONNECT to support
  383.         mailers that generate a single Escape character
  384. 5.60.01 Added code to mask out REPLY lines reading 0:0/0
  385. 5.60.01 Added code to mask out invalid MSGID lines from Xenolink
  386. 5.60.01 Added support for Session Passwords
  387. 5.60.01 Updated processing of Origin information in EchoMail to
  388.         handle invalid formats of the Origin without crashing
  389. 5.60.01 Corrected incoming EchoMail processing logic to handle mail
  390.         from multiple networks simultaneously
  391. 5.60.01 Takes phone off hook during mail tossing
  392. 5.60.01 Modified call to DSZ to handle duplicate incoming file names
  393. 5.60.01 Added abort by spacebar in dialouts
  394. 5.60.01 Added pause between redials
  395. 5.60.01 Corrected processing of nodelists with sub-100 extensions
  396. 5.60.01 Added Carrier Detect functions to detect loss of connection
  397.         in incoming and outgoing calls
  398.  
  399. 5.60.00 Added incoming AreaFix functionality
  400. 5.60.00 Added incoming & outgoing Crash Mail functionality
  401. 5.60.00 Added incoming & outgoing File Attach functionality
  402. 5.60.00 Added incoming & outgoing File Request functionality
  403. 5.60.00 Integrated the FrontDoor telephone handling functionality
  404. 5.60.00 Introduced support for Domains
  405. 5.60.00 Upgraded routing to give unlimited routing flexibility
  406. 5.60.00 Introduced support for Aliases
  407. 5.60.00 Introduced support for simultaneous multiple Fido-type networks
  408. 5.60.00 Reintroduced the PATH statement in EchoMail
  409. 5.60.00 Introduced support for unarchived EchoMail
  410. 5.60.00 Improved the detection of origin information on incoming EchoMail
  411. 5.60.00 Added processing to correct Private EchoMail and Public Netmail
  412. 5.60.00 Added support for To: field in EchoMail
  413. 5.60.00 Upgraded to support VBBS 5.60
  414.  
  415. 5.52.04 Corrected the problem that was preventing messages from Fido being
  416.         gated out to VirtualNET clients and servers
  417. 5.52.04 Improved the detail provided on-screen as messages are being
  418.         processed (to give you something to read as the program chugs
  419.         slowly along!)
  420. 5.52.04 Cured the problem of VFIDO "reflecting" EchoMail back to the
  421.         original sender thereby causing duplicates
  422. 5.52.04 Corrected the display of the From address for incoming EchoMail so
  423.         that it no longer always shows the Server's address
  424. 5.52.04 Removes the AREA and SEEN-BY lines from incoming EchoMail before
  425.         posting it to VBBS
  426. 5.52.04 Introduced an automatic word-wrap on incoming messages to cater for
  427.         those annoying Fido mailers that fail to word-wrap their messages as
  428.         they are entered
  429.  
  430. 5.52.03 Corrected another bug in the usa of LHA for archiving
  431.  
  432. 5.52.02 Corrected a bug that was making the VBBS mail tosser skip messages
  433.  
  434. 5.52.01 Corrected the use of LHA as an archiving and unarchiving protocol
  435.         since it was making VFIDO crash
  436.  
  437. 5.52.00 Completely rewrote echomail handling for multiple clients (the
  438.         last version was my first attempt and was not too good!)
  439. 5.52.00 Added recognition of soft carriage returns in message text
  440. 5.52.00 Corrected SEEN-BY line on echomail to show NET/NODE only
  441. 5.52.00 Forced e-mail to use real name
  442. 5.52.00 Corrected FLAGS for file-attached archived message packets
  443. 5.52.00 Corrected expected name of NODELIST files
  444. 5.52.00 Added a VFIDO.LOG file that records file access attempts to help
  445.         debug obscure file problems
  446.  
  447. 5.51.00 Added support for VBBS 5.51
  448.  
  449. 5.50.06 Added support for multiple servers and multiple EchoMail clients
  450.         (this was a MAJOR job, let me tell you!)
  451. 5.50.06 Corrected bug causing crashes if subdirectories under NETMAIL
  452. 5.50.06 Fixed crash caused by blank lines in NET.0
  453. 5.50.06 Fixed crash caused by archived NODELIST in VFIDO /A
  454.  
  455. 5.50.05 Fixed ARCmail file attach message bug
  456. 5.50.05 Fixed INTL addressing bug
  457.  
  458. 5.50.04 Fixed horrendous bug in the 5.50.03 EchoMail processor
  459.  
  460. 5.50.03 Rewrite of mail processor to handle large messages
  461.  
  462. 5.50.02 Fido mail addressed to SysOp is routed to #1 account
  463. 5.50.02 Origin line now has only 1 leading space
  464. 5.50.02 SEEN-BY and PATH now in correct order on Conference mail
  465.  
  466. 5.50.01 Failure to toss Fido Conference mail to VBBS message areas
  467.  
  468. 2.2     Fixed bug in showing Fido node in VBBS
  469.  
  470. 2.1     Fixed bug in Fido echomail to VBBS conversion
  471.  
  472. 2.0     First Public Release
  473.  
  474. 1.5     Beta
  475.  
  476. 1.4     Beta
  477.  
  478. 1.3     Beta
  479.  
  480. 1.2     Beta
  481.  
  482. 1.1     Beta
  483.  
  484. 1.0     Beta
  485.